home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / CAD / LASI35B2.ARJ / TLC.HLP < prev    next >
Text File  |  1991-08-01  |  10KB  |  248 lines
  1.  
  2. Introduction
  3.  
  4.                 Transportable LASI Cell Data Format (TLC)
  5.  
  6.  
  7.   TLC is a form of LASI cell data that is easily understood by people. It
  8.   contains the information needed to construct a cell, and therefore move a
  9.   cell from one drawing directory to another. It is also useful as a
  10.   convenient format for making conversions into other drawing system
  11.   formats and formats for I/O devices. TLC files are ASCII sequential files
  12.   that should be easily readable by programming languages including BASIC
  13.   and C. In TLC format there is only one file per cell, nomatter what the
  14.   cell rank.
  15.  
  16.   Cell files in TLC are called EXTERNAL files, while cell files used by
  17.   LASI directly (.BPV and .CEL) are called INTERNAL files. TLC files have
  18.   the extension .TLC in DOS. Internal files are designed for the computers
  19.   convenience, while external files are designed for human convenience.
  20.  
  21.   Using TLC is the ONLY WAY that cells can be installed in a LASI drawing
  22.   from an external source. This is because the internal files use a pointer
  23.   system of referring to a cell to save memory space. This pointer is the
  24.   position in the CELLS.DBD file of a cell's information, which cannot be
  25.   changed without changing all cell references. The program TLC.EXE takes
  26.   referencing into account and adjusts accordingly.
  27.  
  28.   Since each cell has its own TLC file, a TLC file may not really contain
  29.   all the information to construct a cell if it has lesser cells within it.
  30.   In that case, the TLC files for the lesser cells will have to be present
  31.   for conversion to internal form. When converting to external form, the
  32.   TLC.EXE program is smart enough to make the TLC files of any lesser cells
  33.   automatically.
  34.  
  35.   When conversion from external to internal is being done, the lesser cells
  36.   will also be made in internal form if they are not already present in the
  37.   drawing cell collection. You may optionally also replace any cells that
  38.   are already there with new ones.
  39.  
  40.  
  41. Conversion Options
  42.  
  43.   The TLC.EXE program has 4 Conversion Options, two for conversion TO TLC
  44.   and two FROM TLC:
  45.  
  46.   1.  Convert ALL Cells to TLC:
  47.     ALL Cells are converted from the source to the destination. This is the
  48.   standard drawing dump to TLC form.
  49.  
  50.   2.  Convert NAMED Cells to TLC:
  51.     NAMED cells are converted to TLC from the source to the destination.
  52.   Cells that are needed to construct a cell of greater rank are also
  53.   converted as an option.
  54.  
  55.   3.  Convert ALL Cells from TLC:
  56.     This requires that the CELLS.REF file exist at the source. The names of
  57.   all the cells at the source are simply read from the CELLS.REF file in
  58.   that location and are converted as if they had been named individually in
  59.   Option 4. If the CELLS.REF file is missing at the source then Option 4
  60.   only may be used.
  61.  
  62.   4.  Convert NAMED Cells from TLC:
  63.     NAMED cells are converted to internal files. The CELLS.DBD file at the
  64.   destination is augmented with the NAMED cell. If lesser cells are needed
  65.   they are also converted from the source TLC into internal files at the
  66.   destination. If the cells are not present at the destination they will be
  67.   converted automatically. If the lesser cells are present at the
  68.   destination you will have the option to replace them with new ones.
  69.   Therefore, to fully reconstruct a cell from TLC, all lesser cells must be
  70.   present either in the source or destination cell collections in TLC or
  71.   internal form.
  72.  
  73.   When converting back from TLC form, the TLC program knows if a cell is in
  74.   the destination by reading the CELLS.DBD file. TLC will replace the named
  75.   cell but will OPTIONALLY replace lesser cells, the cells within the named
  76.   cell. If any cells do not exist in the drawing cell collection they will
  77.   be made.
  78.  
  79.   If the CELLS.DBD file is not present at the destination, then one is
  80.   made.
  81.  
  82.   To convert a complete layout drawing from TLC, you start with a blank
  83.   directory, and name the main drawing cell to be converted (or use Option
  84.   3). The TLC program then reconstructs the whole drawing by making all
  85.   lesser cells first, and then the named main cell.
  86.  
  87.   In all options the CONSTS.DBD file of the source or destination directory
  88.   is left unaffected. If a drawing is reconstructed from TLC, you must load
  89.   your favorite CONSTS.DBD file, or let LASI provide a default one when it
  90.   starts up.
  91.  
  92.  
  93. Running TLC.EXE
  94.  
  95.   When running TLC.EXE you pass parameters as arguments on the DOS command
  96.   line. Arguments are separated by one or more spaces.
  97.  
  98.   The FIRST parameter is the CONVERSION DIRECTION consisting of the brace
  99.   characters "{" or "}". The direction is indicated by how the brace points
  100.   at "tlc".  For example, "tlc { etc." converts to TLC form.
  101.  
  102.   The SECOND is the SOURCE path, the disk name or "." for the current
  103.   directory.
  104.  
  105.   The THIRD is the DESTINATION path, the disk name or "." for the current
  106.   directory.
  107.  
  108.   The NEXT parameters are needed only if options 2 or 4 are be used, and
  109.   are a list of up to 10 NAMES of cells to be converted according to that
  110.   option.
  111.  
  112.   Hint:  Run the TLC.EXE program without any arguments to get HELP.
  113.  
  114.   Important:  The FORM.DBD file must always be present in the directory
  115.   where the internal (.BPV and .CEL) files exist or are to be generated.
  116.   TLC.EXE needs this information to allocate space.
  117.  
  118.  
  119.   Things to remember when converting:
  120.  
  121.     ∙ The first THREE parameters MUST be present to be counted correctly.
  122.  
  123.     ∙ For options 1 and 3 the file CELLS.DBD or CELLS.REF must be in the
  124.       source directory.
  125.  
  126.     ∙ If there are no NAME parameters, options 1 and 3 are assumed and
  127.       performed according the the direction of the brace character.
  128.  
  129.  
  130. The CELLS.REF File
  131.  
  132.   As TLC makes it, the CELLS.REF file is a copy of CELLS.DBD.
  133.  
  134.   You may change the CELLS.REF file to convert modified lists of cells into
  135.   Internal form.
  136.  
  137.   To remove a cell, delete the cell's name and the data line that follows
  138.   it in the CELLS.REF file.
  139.  
  140.   To add a cell, insert the cell's name on a single line and then the
  141.   cell's rank on the next line. You don't need any additional data on the
  142.   second line.
  143.  
  144.   The entry on the first line of the CELLS.REF file is the number of cells
  145.   in the file. If you add or delete cells, you should adjust this number.
  146.   When TLC converts to Internal form using CELLS.REF, it counts either to
  147.   the number of cells it reads on the first line or to the end of the file,
  148.   whichever comes first.
  149.  
  150.   Do all this with a text editor that produces standard DOS text files.
  151.  
  152.  
  153. TLC Format Details
  154.  
  155.   Cell files in TLC have a record structure. The are presently four kinds
  156.   of records: Header, Cell, Box and Path.  The Header record contains
  157.   useful information regarding the cell being translated, most important,
  158.   the rank and scale of the cell.
  159.  
  160.   The records for the objects in the cell are preceded by an "equals code"
  161.   consisting of two characters: the first being "=" and the second being
  162.   "H", "C", "B" or "P" for Header, Cell, Box or Path respectivly. The TLC
  163.   program then looks for the type of object to be made and acts
  164.   accordingly. If at some time in the future, other objects are added to
  165.   LASI, similar code will be used.
  166.  
  167.   If a data error is encountered during translation, it is possible that
  168.   one or two objects may be incorrectly reconstructed from TLC. The equals
  169.   code will try to resynchronize the data and correct translation will then
  170.   resume. The Header record contains an object count and this is compared
  171.   to the actual number of objects made, and miscounts are indicated by the
  172.   TLC program.
  173.  
  174.   All records, including the Header, may be written in any order in a TLC
  175.   file.
  176.  
  177.  
  178.   Header Record:      <nl>= carriage return + linefeed    <sp>= space
  179.  
  180.       1= "=H" (literal)<nl>
  181.       2= Name of Cell (DOS file name)<nl>
  182.       3= Version of LASI (literal)<nl>
  183.       4= Version of TLC (literal)<nl>
  184.       5= Basic Units per Physical Unit<nl>
  185.       6= Name of Physical Unit (literal)<nl>
  186.       7= Date of Cell Conversion (literal)<nl>
  187.       8= Time of Cell Conversion (literal)<nl>
  188.       9= Rank of Cell<sp>
  189.       10= Left Outline Boundary in basic units<sp>
  190.       11= Bottom Boundary in basic units<sp>
  191.       12= Right Boundary in basic units<sp>
  192.       13= Top Boundary in basic units<nl>
  193.       14= Number of Boxes<sp>
  194.       15= Number of Paths<sp>
  195.       16= Number of Vertices<sp>
  196.       17= Number of Cells<nl>
  197.  
  198.       Note:  Versions must begin with a numeric character
  199.  
  200.   Cell Record Entries:
  201.  
  202.       1= "=C" (literal)<nl>
  203.       2= Name of Lesser Cell<nl>
  204.       3= Orientation (see below)<sp>
  205.       4= X Position in basic units<sp>
  206.       5= Y Position in basic units<sp>
  207.       6= reserved (presently zero)<nl>
  208.  
  209.       Orientation Number: (0-15)
  210.         16 bit integer, all bits 0 except:
  211.  
  212.           Bit 4,
  213.             0= draw cell fully
  214.             1= draw cell outline
  215.  
  216.           Bit 3,
  217.             0= cell not flipped
  218.             1= cell is flipped in X before rotation
  219.  
  220.           Bits 2 and 1,
  221.             0,0 = no rotation
  222.             0,1 = 90 deg rotation CCW
  223.             1,0 = 180 deg rotation CCW
  224.             1,1 = 270 deg rotation CCW
  225.  
  226.   Box Record Entries:
  227.  
  228.       1= "=B" (literal)<nl>
  229.       2= Layer of Box<sp>
  230.       3= X of Lower Left Corner in basic units<sp>
  231.       4= Y of L ower Left  Corner in basic units<sp>
  232.       5= X of Upper Right Corner in basic units<sp>
  233.       6= Y of Upper Right Corner in basic units<nl>
  234.  
  235.   Path/Poly Record Entries:
  236.  
  237.       1= "=P" (literal)<nl>
  238.       2= Layer Of Path/Poly<sp>
  239.       3= Width in basic units<sp>
  240.       4= No. of Vertices in path/poly<nl>
  241.       5= Vertices in basic units in the form:
  242.       X1<sp>Y1<sp>X2<sp>Y2<sp>X3<sp>Y3<sp>X4<sp>Y4<sp>X5<sp>Y5<nl>
  243.       .......Xn-1<sp>Yn-1<sp>Xn<sp>Yn<nl>
  244.  
  245.       (Groups of 5 coordinates separated by <sp> ended by <nl>,
  246.       always with <nl> after Last Coordinate Pair)
  247.  
  248.